home *** CD-ROM | disk | FTP | other *** search
/ Cream of the Crop 21 / Cream of the Crop 21 (Terry Blount) (October 1996).iso / bbs / king821.zip / KING.DOC < prev    next >
Text File  |  1996-07-26  |  19KB  |  425 lines
  1.                              King of the Board
  2.              Copyrighted June 1988,1989,1990,1991,1992,1993,1994
  3.                    By Chuck Valecek - Suburban Software
  4.                              Version 8.17
  5.                             
  6.  
  7. BACKGROUND
  8.  
  9.     King of the Board started about a 6 years ago as a Door written in 
  10. QuickBasic, and incorporated Door routines in DOORPATCH. Since then, 
  11. it has been modified from version 1.0 through 5.4 with suggestions 
  12. by users and Sysops. It has become very popular with PCBoards all 
  13. over the country and very popular with the users.
  14.  
  15.     The 7.0 was the first official release of the door which was completly
  16. rewritten using Turbo Pascal and ProKit Door routines. This will, I hope,
  17. satisfy those Sysops who wanted to use the door but could not, due to
  18. the newer modem speeds and system incompatibilities.
  19.  
  20.     Since the version 7 release there have been quite a few sysops that are
  21. running the door under BBS software other than PCBoard. This was a real task
  22. since the door required PCBoard files. There were converters to create the
  23. files but some sysops still had problems getting the DOOR to run correctly.
  24.  
  25.     Introducing version 8.0. This version is a complete rewrite of the 7.0
  26. version. This time it supports MOST major brands of BBS Software. A list of
  27. the supported Systems are described later in this file.
  28.  
  29. FILES
  30.  
  31. The following files are either included in the package or created by the door.
  32.  
  33. KINGxxx.EXE  The door program itself (xxx would be the version number)
  34. QUESTION.DAT Question file (included)
  35. NEXTQUES.DAT Next question (created by the door)
  36. NEW_QUES.DAT New questions entered by the users (created by the door)
  37. KOBUTLxx.EXE Utility program to list users etc (included)
  38. KING.CFG     Sample config file
  39. KINGxxx      Sample batch file
  40. KING.LOG     Optional log file (created by the door)
  41. KING.HLP     Help file
  42. KINGP.HLP    Help file if using the Point version.
  43. KOBG.DAT     Sign on screen for King - Color Version
  44. QOBG.DAT     Sign on screen for Queen - Color Version
  45. KOB.DAT      Sign on screen for King - No Color
  46. QOB.DAT      Sign on screen for Queen - No Color
  47. ADOPT.DAT    Sample of a Adopt-a-door screen that can be used - No Color
  48. ADOPTG.DAT   Sample of a Adopt-a-door screen that can be used - Color
  49.  
  50.  
  51. THE DOOR
  52.  
  53.     King is a trivia game in which users try to make it up the pyramid
  54. to the top. To accomplish this, the user must challenge another user 
  55. in a position above him. The user is asked a question and if he gets 
  56. it right he changes places with the user he challenged. It's a quick 
  57. game and won't tie up your board as some games do, because the user is 
  58. asked only one question and is allowed only one play per day. He may 
  59. call back tomorrow and find himself back were he was or even further
  60. down the pyramid. If the user is beyond the playing grid (only 28 
  61. users on the grid) he can challenge only the 26th, 27th, and 28th 
  62. positions. If he is on the grid he can only challenge one of the next 
  63. three players. After the player has a turn he is asked if he would 
  64. like to enter a qustion into the game. These questions are placed in 
  65. a hold file for the sysop to review and merge into the question 
  66. file. Each time a user calls in the question is changed. The program 
  67. reads the question file sequentially so the more questions in the 
  68. file the less chance the user will get a repeat. The sysop also has 
  69. the option to limit the number of chances the user gets to answer 
  70. correctly. I use 3 and it seems to work out just fine. One sysop, I 
  71. won't mention his name, changes the number of chances, so his users 
  72. never know how many tries they get. The format of the question is 
  73. shown to the user. All alpha characters are replaced with a *, all 
  74. digits are replaced with a N and special characters (!@#$$%) are 
  75. shown as is. After each guess the user is prompted to see if he 
  76. would like to try again. If so, the correct letters are replaced so 
  77. as to give him a hint. This helps if the user is unsure of the 
  78. correct spelling. Only letters that are in the correct position are 
  79. replaced.
  80.  
  81.  
  82.    There is an option that allows the sysop to choose whether he 
  83. wants the game to use a point system. The point system assigns a 
  84. point value to the person being challenged. The points are assigned 
  85. as follows: A person 3 positions above the player is worth 2500 
  86. points. A person 2 positions above the player is worth 2000 points. 
  87. A person 1 position above the player is worth 1500 points.
  88.  
  89. If the player answers the question incorrectly the person he 
  90. challenged gets a bonus of 500 points.
  91.  
  92. If you choose to set the point option, an extra bulletin file will be created 
  93. by the door which will contain the point standings. This will only 
  94. appear if the point option is set. The user will also be asked if he 
  95. would like to review the file before the door terminates. If you 
  96. wish, this file could be copied over as a bulletin in the door batch 
  97. file.
  98.  
  99.  
  100.  
  101.    That's about it for the door operation. It's simple yet fun!
  102.  
  103. SETUP
  104.  
  105.     Most of you out there are familiar with the setup of a door. This door 
  106. follows the standard setup of Doors.
  107.  
  108.  
  109. Since the config file has gotten so large, I have incorporated a configuration
  110. option in the KOBUTLxx.EXE. It will allow you to edit or create the config file
  111. through a series of prompts. Answer the prompts and a config file will be
  112. created. You can always rerun the program to create another file or edit your
  113. existing config file. 
  114.  
  115. If you are a previous registered sysop of King of the Board your old 
  116. registration number will work with this door.
  117.  
  118.  
  119. And you thought it was hard!
  120.  
  121. Okay, now to set up a batch file for the door to run. Remember this is just like
  122. any other batch file except there is no ".BAT" extension.
  123.  
  124. The standard DOOR script for ProKit doors has this format:
  125.      echo off
  126.      cd \king
  127.      KINGxxx KINGxxx.CFG 
  128.      cd \pcb
  129.      board
  130.  There is nothing else required in this batch file.
  131.  
  132.  
  133. UTILITIES
  134.  
  135. Okay, now to the new Sysops. There is a program called KOBUTLxx.EXE. This 
  136. utility will display the users file, print the users file, Purge users from the users
  137. file, Verify the question file (explained later), Merge the new questions into
  138. the question file, Create a TEXT file from the question file for editing and
  139. rebuild the question file from a TEXT file. Since the question file is a
  140. encrypted file it may look like gibberish to you. Choosing the option
  141. Convert to text will allow you to use any text type editor and edit the questions
  142. or answers, and then rebuild the question file. All the options are 
  143. in LOTUS type menus. Select the option with the arrow keys and press 
  144. return.
  145.  
  146.     The questions entered by the users go into a file called NEW_QUES.DAT.
  147. This is a standard text file and can be edited with any text editor. Edit this
  148. file before merging the new questions into the question file.
  149. The format of the data is question,answer,user. That is the question followed
  150. by a comma followed by the answer followed by a comma followed by the username.
  151. As of this release all three (3) fields must be present.
  152.  
  153.  
  154.     If you convert the question file into a text file, the first line will be 
  155. the number of questions in the file. Example: 1147,0. There is no need to change 
  156. this record. Leave as it is the KOBUTLxx will place the correct number of 
  157. questions in the first record. Why this record? The door creates a file called
  158. NEXTQUES.DAT that contains the number of the next question. If this number
  159. exceeds the number of questions it will reset to 2 allowing the first question
  160. to be asked. In future release this may be removed and a editor built into the
  161. KINGUTIL to accomodate editing of the questions. But for now this is the way
  162. it has to be.
  163.     
  164.     PLEASE edit your new question file!!! I have had users call me long
  165. distance to complain that they lost because of a word was entered incorrectly.
  166. This is not MY problem. It's up to you to insure that the answers are correct.
  167.  
  168.     I believe I have tried to cover most of the requirements of the programs.